Graph cho Hotmail và Outlook: Cách nhận email bằng OAuth 2.0

Microsoft Graph (OAuth2.0) là phương thức truy cập dữ liệu email phổ biến do Microsoft chính thức cung cấp. Phương thức này có thể được sử dụng để đọc nội dung email trong các hộp thư Microsoft như Hotmail và Outlook. So với các giao thức email truyền thống, Graph API phù hợp hơn cho việc đọc email mã xác minh, nhận email tự động, quản lý tài khoản hàng loạt và tích hợp hệ thống.

Tất cả tài khoản Hotmail/Outlook do Hotmail007 cung cấp đều bao gồm Refresh Token và Client ID, có thể dùng để nhận email qua Graph (OAuth2.0). Nếu bạn cần mua số lượng lớn tài khoản Hotmail, tài khoản Hotmail bán buôn, tài khoản Outlook bán buôn hoặc tài khoản email Microsoft hỗ trợ Graph, bạn có thể dùng Hotmail007 API để nhận email nhanh hoặc tự kết nối với Microsoft Graph theo nhu cầu sử dụng.

Nội dung bài viết

1. Nhận email qua Microsoft Graph (OAuth2.0) là gì?

2. Vì sao Graph cần Refresh Token và Client ID để nhận email?

3. Sử dụng Hotmail007 API để nhanh chóng lấy email mới nhất

4. Tự kết nối Microsoft Graph để đọc email

5. Cách chọn phương thức nhận email phù hợp

6. Lưu ý khi sử dụng Graph để nhận email
   

1. Nhận email qua Microsoft Graph (OAuth2.0) là gì?

Microsoft Graph là API chính thức của Microsoft, có thể dùng để truy cập email Outlook, danh bạ, lịch và các dữ liệu tài khoản Microsoft khác.

Trong trường hợp nhận email Hotmail/Outlook, Graph (OAuth2.0) đọc dữ liệu hộp thư thông qua thông tin ủy quyền thay vì chỉ dựa vào các giao thức email truyền thống. Nói đơn giản, nhiều phương thức nhận email cũ chủ yếu dùng địa chỉ email và mật khẩu để kết nối với máy chủ email. Graph cần Refresh Token và Client ID để hoàn tất ủy quyền trước khi đọc email.

Phương thức này phù hợp để đọc email mã xác minh, nhận email tự động, quản lý hàng loạt tài khoản Hotmail/Outlook và tích hợp chức năng nhận email vào hệ thống riêng.

Nếu người dùng sử dụng công cụ nhận email của bên thứ ba, thường cần điền địa chỉ email, mật khẩu, Refresh Token, Client ID và các thông tin cần thiết khác theo yêu cầu của công cụ.

2. Vì sao Graph cần Refresh Token và Client ID để nhận email?

Graph (OAuth2.0) sử dụng cơ chế ủy quyền để đọc email. Đối với việc nhận email Hotmail/Outlook qua Graph, Refresh Token và Client ID là hai trường rất quan trọng.

• Refresh Token: dùng để duy trì ủy quyền và lấy quyền truy cập

• Client ID: dùng để xác định ứng dụng được ủy quyền tương ứng

• Access Token: được chương trình lấy tạm thời trong quá trình gửi yêu cầu; người dùng thông thường thường không cần nhập thủ công

Tất cả tài khoản Hotmail/Outlook do Hotmail007 cung cấp đều bao gồm Refresh Token và Client ID. Định dạng giao hàng phổ biến là:

email:password:refreshToken:clientId

Định dạng này có thể được dùng để lấy email mới nhất qua Hotmail007 API, sử dụng với công cụ nhận email của bên thứ ba hoặc tự viết mã kết nối với Microsoft Graph.

Lưu ý rằng Refresh Token thường có hiệu lực khoảng 3 tháng kể từ khi tạo, tùy thuộc vào trạng thái ủy quyền thực tế của tài khoản. Nếu Token hết hạn hoặc không còn hợp lệ, bạn cần thay bằng Token hợp lệ mới hoặc lấy lại thông tin ủy quyền.

Một số người dùng có thể gặp lỗi yêu cầu do môi trường mạng hoặc trạng thái IP trong quá trình sử dụng thực tế. Nếu nhận email qua Graph không thành công, trước tiên hãy kiểm tra Refresh Token, Client ID, định dạng tài khoản, tham số yêu cầu và môi trường mạng.

3. Sử dụng Hotmail007 API để nhanh chóng lấy email mới nhất

Hotmail007 API phù hợp để nhanh chóng lấy email mới nhất từ một hộp thư Hotmail/Outlook cụ thể. Người dùng có thể điền tham số trên trang tài liệu API và sao chép liên kết yêu cầu được tạo, hoặc tích hợp API vào chương trình để gọi hàng loạt.

Tài liệu API:

https://hotmail007.com/api-docs

Sau khi vào tài liệu API, hãy tìm:

04 Get the latest email of the specified email account

API này lấy email mới nhất từ tài khoản email được chỉ định dựa trên thông tin tài khoản, thư mục hộp thư và thời gian bắt đầu tùy chọn.

Địa chỉ API:

https://gapi.hotmail007.com/open/mail/latest

Tham số yêu cầu:

• clientKey: API Key của bạn

• account: thông tin tài khoản đầy đủ theo định dạng email:password:refreshToken:clientId

• folder: thư mục email, chỉ hỗ trợ inbox hoặc junkemail. inbox dùng để lấy email mới nhất trong hộp thư đến, junkemail dùng để lấy email mới nhất trong thư mục rác

• start_timestamp: tùy chọn, chỉ trả về email nhận sau Unix timestamp chỉ định, tính bằng giây
  

3.1 Tạo liên kết yêu cầu trên trang tài liệu API

Đối với người dùng không quen lập trình, có thể sử dụng trực tiếp giao diện kiểm tra trong tài liệu API.

Sau khi điền clientKey, account và folder vào giao diện kiểm tra, trang sẽ tự động tạo ví dụ yêu cầu. Sao chép liên kết được tạo và mở trong trình duyệt để xem email mới nhất.

Cách này phù hợp để kiểm tra email tạm thời, đọc email mã xác minh hoặc nhanh chóng kiểm tra xem hộp thư Hotmail/Outlook có thể nhận email bình thường hay không.

3.2 Gọi API bằng chương trình

Nếu cần lấy email mới nhất hàng loạt, bạn có thể tích hợp Hotmail007 API vào script hoặc hệ thống của mình.

Ví dụ Python:

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder
    }
)

print(resp.text)

Nếu cần lọc email theo thời gian, hãy thêm start_timestamp:

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"
start_timestamp = 1710000000

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder,
        "start_timestamp": start_timestamp
    }
)

print(resp.text)

Cách này phù hợp cho việc đọc email mã xác minh, nhận email đăng ký nền tảng, nhận email Hotmail hàng loạt và tự động hóa email Outlook.

4. Tự kết nối Microsoft Graph để đọc email

Nếu bạn muốn kết nối trực tiếp với Microsoft Graph API chính thức, bạn có thể sử dụng Refresh Token và Client ID từ định dạng tài khoản đầy đủ để thực hiện yêu cầu ủy quyền, sau đó đọc email trong hộp thư đến Outlook. So với Hotmail007 API, chủ yếu dùng để nhanh chóng lấy email mới nhất, việc tự kết nối Microsoft Graph phù hợp hơn với các tình huống cần truy cập nhiều email, lọc danh sách email hoặc xử lý thêm nội dung email.

Quy trình cơ bản:

1. Chuẩn bị định dạng tài khoản đầy đủ: email:password:refreshToken:clientId

2. Lấy Refresh Token và Client ID từ thông tin tài khoản

3. Lấy quyền truy cập tạm thời thông qua endpoint OAuth2.0

4. Gọi Microsoft Graph mail API để đọc email trong inbox

Ví dụ Python:

import requests


def get_access_token(refresh_token: str, client_id: str) -> str:
    res = requests.post(
        "https://login.microsoftonline.com/common/oauth2/v2.0/token",
        data={
            "client_id": client_id,
            "grant_type": "refresh_token",
            "refresh_token": refresh_token,
            "scope": "https://graph.microsoft.com/.default"
        }
    )
    res.raise_for_status()
    return res.json()["access_token"]


def print_inbox(access_token: str) -> None:
    res = requests.get(
        "https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages",
        headers={"Authorization": f"Bearer {access_token}"}
    )
    res.raise_for_status()

    for mail in res.json().get("value", []):
        print(f"Subject: {mail.get('subject')}")
        print(f"From: {mail.get('from', {}).get('emailAddress', {}).get('address')}")
        print(f"Text: {mail.get('bodyPreview')}")
        print("-" * 50)


account = "email:password:refreshToken:clientId"

parts = account.split(":")
refresh_token = parts[2]
client_id = parts[3]

access_token = get_access_token(refresh_token, client_id)
print_inbox(access_token)

5. Cách chọn phương thức nhận email phù hợp

Nếu bạn chỉ muốn nhanh chóng xem email mới nhất từ hộp thư Hotmail/Outlook, bạn có thể sử dụng Test Interface trong tài liệu API của Hotmail007. Sau khi điền tham số, hãy sao chép Request Example được tạo và mở trong trình duyệt.

Nếu bạn cần lấy email mới nhất hàng loạt, bạn có thể gọi trực tiếp Hotmail007 API và tích hợp vào script hoặc hệ thống.

Nếu bạn cần xử lý email linh hoạt hơn, chẳng hạn như đọc nhiều email, lọc email hoặc phân tích nội dung email, bạn có thể kết nối trực tiếp với Microsoft Graph.

Tóm lại:

• Xem nhanh email mới nhất: sử dụng Test Interface của Hotmail007 API

• Lấy email mới nhất hàng loạt: gọi Hotmail007 API

• Tùy chỉnh logic xử lý email: kết nối Microsoft Graph
  

6. Lưu ý khi sử dụng Graph để nhận email

Khi sử dụng Microsoft Graph (OAuth2.0) hoặc Hotmail007 API để nhận email, bạn nên kiểm tra các thông tin sau:

• Định dạng account có phải là email:password:refreshToken:clientId không

• Refresh Token còn hợp lệ không

• Client ID có chính xác không

• folder có được đặt là inbox hoặc junkemail không

• clientKey có chính xác không

• Tham số yêu cầu có đầy đủ không

• Môi trường mạng có ổn định không

Refresh Token thường có hiệu lực khoảng 3 tháng kể từ khi tạo, tùy thuộc vào trạng thái ủy quyền thực tế của tài khoản. Để duy trì việc nhận email Hotmail/Outlook ổn định, bạn nên kiểm tra trạng thái Token định kỳ.

Kết luận

Microsoft Graph (OAuth2.0) hiện là một phương thức API phổ biến để nhận email cho Hotmail/Outlook. Phương thức này phù hợp cho việc nhận email nhanh, đọc email mã xác minh, xử lý email tự động và quản lý hộp thư hàng loạt.

Tất cả tài khoản Hotmail/Outlook do Hotmail007 cung cấp đều bao gồm Refresh Token và Client ID. Định dạng giao hàng phổ biến là email:password:refreshToken:clientId. Người dùng có thể nhanh chóng lấy email mới nhất qua Hotmail007 API hoặc kết nối trực tiếp với Microsoft Graph bằng Refresh Token và Client ID.

Nếu bạn cần mua số lượng lớn tài khoản Hotmail, tài khoản Hotmail bán buôn, tài khoản Outlook bán buôn hoặc tài khoản Microsoft hỗ trợ Graph (OAuth2.0), Hotmail007 có thể cung cấp tài khoản và hỗ trợ API.